Libris Britannia 4

home *** CD-ROM | disk | FTP | other *** search

/ Libris Britannia 4 / science library(b).zip / science library(b) / COMMUNIC / BULLETIN / 0554.ZIP / RYBBS.DOC < prev next >

Wrap

Text File | 1986-07-24 | 46KB | 1,048 lines

RYBBS Copyright 1986 Gregory J. Ryan (C) Ryan Bulletin Board System Documentaion Updated 7-14-86 by Gregory J. Ryan Edited 7-22-86 by Todd Smith ---------------------------------------------------------------- INTRODUCTION ============ RYBBS is a new entry into the Shareware BBS field. I believe that the power inherent in the Rybbs program can solve most bbs requirements. This document will attempt to describe the different aspects of Rybbs. Like most bbs programs, RYBBS is menu driven. This means that the user is shown a list of choices and usually selects one or more of those choices. Unlike most bbs programs, RYBBS can actually grow in menu size and shape. Each bbs system can be designed exactly the way the sysop desires it. This can mean 50 menus or 1 menu. It's totally up to you, the sysop. Rybbs menus are built of RYBBS commands (described in detail later on in this document). Each command allows the user to perform a certain activity on the bbs. Any command may reside in any menu. You are not limited to one file menu and one message menu. If you feel that this program is worth your time to run, I would appreciate you taking some time to send me a contribution of $35. This will ensure bigger and better revisions of the program. If you are using this program in a commercial application this contribution is mandatory. All contributions should be sent to: Gregory Ryan 4427 N. Morris Blvd. Shorewood, WI 53211 I would like to thank my Beta testers at this point. Dale Klipstein, Peter Ozolins, Matt Vittorio, Dick Laabs, and Todd Smith. Thanks to Todd for helping with the documentation. Gregory J. Ryan * ---------------------------------------------------------------- Files Needed ------------ The following files are required by the RYBBS system and MUST be contained in the current directory or the system may crash! * Rybbs.com - Bulletin board program Rybbs.0** - Bulletin board overlay files First.bbs - First Menu file to run Users.bbs - Users file (will be created if non-existant) Rmess.bbs - Message file #1 (will be created if non-existant) Rline.bbs - Message file #2 (will be created if non-existant) Callers.log- Log of all callers activities (will be created if non-existant) Error.log - Log of fatal errors (will be created) Boards.bbs - List of all the messages boards in the format * Macros.bbs File of user macros (will be created if non-existant) * Upload.bbs File of upload areas Download.bbs File of download areas Optional Files -------------- Other Menu files (may be loaded into memory via the MENUS.BBS file) Note: All optional files can be created using any text editor that writes * ASCII files. * * Filename.que -Questionaire questions Filename.ans -Questionaire answers Use a separate line for each question. Answers will have * a line number corresponding to the question line. * * For example: A questionare about VCRs. (VCR.Que) * * Do you own a VCR? * Do you suscribe to a Cable TV service? * Are you a member in a Tape Rental Club? * How many tapes do you rent per month? * ......etc. * * The answer file (VCR.Ans) will look like this: * * 1 Yes * 2 No * 3 Yes, Fred's Tape Rental * 4 12 tapes * 1 No * 2 ......... etc. * * The filename can be any string 1 to 8 character in length. * The .Que extension is mandatory. The .Ans extension file * will be created automatically, when the first caller responds.* Newuser.que -Questionaire that new users would be forced to respond to * only on the users INITIAL logon to RYBBS. The format is * identical to the Questionare file * Newuser.ans -Answers file for above. Created automatically. * Filename.lin Filename.mes- Name of files that would be alternate message board file. The filename can be any string 1 to 8 characters in length. The .Lin and .Mes extentions are mandatory. Create these * files by copying RMESS.BBS to filename.mes and RLINE.BBS to * filename.lin. Killuser.bbs- Text file that is output to the user when the sysop logs him off using F8. Badfiles.bbs- List of files that may not be downloaded. Nonew.bbs - Contains the log-off message that will be displayed to people trying to log on as new members if the new user lockout is in effect. Badname.bbs - Contains words that may not be used as part of the user's name. Generally this file contains profanity and misc. hacker words. Startup.bbs - Contains initial setups for the RYBBS system. See the description of this file later on in the manual. Limits.bbs - Contains maximum time per day for selected security levels in form of: Security level,maximum time Priority.bbs- Text file output to user that is not of sufficient security level to access the system at a priority time. Events.bbs - Contains the events that are scheduled. Menus.bbs - Contains the names of frequently called menu files (eg first.bbs,files.mnu,mess.mnu etc) NNNNN.bbs Personal file (NNNNN is user number). This will be displayed and then deleted from the disk. Sysop.bbs Text file that will be output when system is not available for chat. Hello.bbs First text file to output (before logon) Welcome.bbs- Second text file to output (before logon) Welcome1.bbs- Third text file to output (after logon) Newuser.bbs- File to be output to a new user. Goodbye.bbs- Exiting text file (output to person logging off) Online.bbs- Text file containing allowable executable programs. The format is the complete program name with all necessary parameters. (e.g. EDITCOM.COM 1 ) MAKE SURE YOU HAVE ENOUGH MEMORY IN YOUR SYSTEM AND MAKE SURE THE ONLINE PROGRAM COMMUNICATES WITH THE COMM PORT! Programs.bbs- Text file containing allowable executable programs. The format is the complete program name with all necessary parameters. (e.g. EDITCOM.COM 1 ) MAKE SURE YOU HAVE ENOUGH MEMORY IN YOUR SYSTEM AND MAKE SURE THE ONLINE PROGRAM COMMUNICATES WITH THE COMM PORT! Files.bbs Contains programs names that are able to be downloaded or have been uploaded. Offhook.bbs Contains modem commands to allow modem to go off-hook (for sysop log-on and sysop utilities) Modeinit.bbs Contains modem commands that will be sent to modem on program startup and after each caller hangs up. Notenuf.bbs File to be output if a user attempts to access a command above his/her security level. .pa ---------------------------------------------------------------- Starting up RYBBS Rybbs is started by typing the following from the keyboard or from within a batch file. C>RYBBS [options] (return) The options are as follows: 2 Allows running the bbs from COM port 2 G Allows graphics to be run and requests graphics capability when a new user logs in. D Debug capability on M Message debug capability on L New user lock out. Disables system from allowing new users. P1 Requires a new user to enter his phone number during the * initial logon to RYBBS. * P2 Requires the user to enter his phone number EVERY time as * an additional password. * Q Activates Questionaire option. * R Allows the reply to a message to have private status even if the message is public. ? Lists the functions of all the options and then halts. These options may be entered in any order but must be separated * by spaces. * For example: Rybbs 2 l d * * This will: Start RYBBS from Com port 2, * lock out new users, and * turns the debug capability on. * The file Startup.BBS duplicates many of these commands without the need of entering it from the command line. Startup.bbs is a text file containing lines of commands that rybbs will read when the program begins operation. The commands are as follows: Command Action Taken graphics graphics available sysop available not available sysop not available nosysop sysop function key screen com1 run on com1 com2 run on com2 lockout lockout new users debug debug on mdebug message debug on private query on privacy of message reply phone requires new user to enter phone # during * initial logon to RYBBS * phone pass requires user to enter phone # as second password * question activates the Questionaire facility including * Newuser questionaire * The first time RYBBS is run, the users file will be created with the sysops name as SYSOP. When the sysop wishes to log in he should type SYSOP; as his name. The semi-colon is IMPORTANT! ---------------------------------------------------------------- File names ---------- Except for the files listed above file names may be any valid IBM DOS file name. Path names are supported and may indeed clean up an otherwise messy directory. For example, if you have a list of bulletins that you wish to display from a seperate menu, the menu may be in another directory and the bulletins may be in another directory menu,b,5,5,[B]ulletins,\bullet\bullet.mnu When the above command is activated (by pressing the 'b' key from the current menu), a new menu by the name of bullet.mnu in the \bullet\ directory (of the current disk) is loaded and displayed. This menu file might look like this: cmnt,x1,5,5,-----------Bulletins----------- text,1,5,5, 1-Local Area Bulletin boards,\bullet\locboards.txt text,2,5,5, 2-National Bulletin boards,natboards.txt text,3,5,5, 3-Computer events scheduled,comevents.txt menu,q,5,5, Q-Quit to main menu,main.mnu cmnt,x2,5,5,-----------Bulletins----------- Graphics -------- If you wish to have graphics capability, you must have two sets of menu files (or text files). The file name will be the same as called out in the menu command EXCEPT the last character before the period will be a "g"! * Example regular file main.mnu graphics file maing.mnu Note: This format restricts the name to 7 characters instead of a normal 8 characters! The program first checks to see if the user has graphics capability. It then searches for the graphics equivilent of the requested file. If the * graphics menu exists, it is output to the screen, otherwise the normal * non-graphics file is output instead. * Another method for achieving graphics is to design a graphics file that will take the place of your menu. You must then have the MENT command in the menu. For example: ment,##,5,5, Graphics Menu ,graph.mnu .... more menu commands that are listed in graph.mnu quer,xx,5,5, Optional QUER command lists short options, etc. ------------------------------------------------------------------- Modem Setup ----------- Hayes modem 1200 12345678 switch settings UUDDDUUD (U=Up, D=Down) Initial logon parameters are 1200 baud,No parity,8 bits,1 stop will change to 1200,even,7,1 automatically. will change to 300,even,7,1 automatically and will change to 300,no parity,8,1 automatically and will change to no parity,8,1 for xmodem protocol file transfer ====================== Avatex 1200 external 12345678 switch settings UUUUUUUU (U=Up, D=Down) In addition the Modeinit.bbs file must be added for correct startup of the modem. The only line needed in the file is: ATAA The optional file MODEINIT.BBS may contain lines of text that will be sent to the modem upon start up of the program and each time a user hangs up. Each line is sent to the modem followed by a carriage return and a small delay. If MODEINIT.BBS doesn't exist then the default commands sent are: ATZ (RETURN) ATM0X1V1S0=1 (RETURN) ---------------------------------------------------------------- Menus ----- The menus are text files and are set up in the following format command_name,command_entry,security to view, security to execute,text,Filename 1) The command_name is always a four letter word. this is the element that the program recognizes as a command. 2) The Command_entry is a 1 to 3 letter (or number) string that will execute the command_name command when it is entered at the command line or from within a MULT command. This will appear in the short menu on the command line. 3) The security to view is the security to allow a person actually view the command text. It is an integer value. 4) The security to execute is the security to allow a person execute the command. As you can see the person can execute an invisible command if that is what the sysop desires. Alternately, the person may not be able to execute a VISIBLE command. This is also an integer value. 5) This is the text that appears on the long menu (when expert status is turned off). This text can be up to 50 characters in length. 6) This is a parameter that is necessary only with certain commands and will usually define a filename or path. This filename/path can be up to 50 characters in length. Pathnames are ALWAYS finished with a \ character. Make sure no invisible characters are entered into the command lines. Failure to do so may make the command invalid. For example: Menu menu,b,5,5,(B)ulletins,bulletin.bbs The command is menu (which when chosen will load and display a new menu). The long menu will have the string '(B)ulletins' without the quotes. The person will have to type in b (upper or lower) and then return. If the persons security is >=5 the program will load in a menu file with the name of bulletin.bbs (in the current directory). Pathnames are allowed so the filename could have been \newdir\bulletins\bulletin.bbs. Here is a typical menu for a message area. cmnt,xxc,5,5,=========== Message Menu ===========, entr,e,5,5,| [E]nter a message |, mess,r,5,5,| [R]ead a message |, scan,s,5,5,| [S]can messages |, menu,m,5,5,| [M]ain menu |,main.bbs xprt,x,5,5,| [X]pert toggle |, chgm,c,5,5,| [C]hange boards |, quit,g,5,5,| [G]oodbye |, cmnt,xxc,5,5,=========== Message Menu ===========, cmnt,c,5,5, Frequently called menus may be entered into the menus.bbs file in the format of 1 menu name per line. These will be loaded into memory on program startup. Thereafter, if one of the designated menus is called, a disk access is not performed. The number of 'resident' menus is limited only by the amount of memory you have available in the system. Menu restrictions ----------------- Menus can have up to 30 command lines String lengths as listed in above descriptions MENU COMMANDS ------------- The following commands are allowable. All commands may be activated from ANY menu that you (sysop) desire. A MAXIMUM of 30 commands may be contained in any menu. Make sure that the menus are written with a word processor that doesn't put control characters in the file (unless that is what you intend!). The IBM internal graphics characters are ok. MESSAGE COMMANDS ---------------- Shof - Shows the current message board enabled (or all). This command may be located anywhere in the menu that's desired. The access and view security should be set higher then 100 (because they have no effect and should not be viewed or executed). Example Shob,xc,105,105, Invisible Show Board command, Scan - Scan the message file for message headers. Summerizes messages by showing name from , name to , board, and summery. The optional filename would access a special message board. Filename is entered WITHOUT an extention. The RYBBS program will put the extensions on. Example: Scan,s,5,5, [S]can messages,[Filename] Mess - Read a message from the message file. The program asks for a message number or * for the last message read. The optional filename would access a special message board. Filename is entered WITHOUT an extention. The RYBBS program will put the extensions on. Example Mess,r,5,5, [R]ead messages,[Filename] Entr - Enter a message into the message file. The currently selected board is used as the area if one is selected. If all boards are selected then the program will query the user as to the desired board of the message.The optional filename would access a special message board. Filename is entered WITHOUT an extention. The RYBBS program will put the extensions on. example: Entr,l,5,5, [L]eave a message,[Filename] Chek - Check message file for messages that the current users either left or has waiting. When the bbs session starts the messages file is checked starting at the last message read. When this command is activated from a menu file, the entire message file is checked and all applicable message numbers are shown. The optional filename would access a special message board. Filename is entered WITHOUT an extention. The RYBBS program will put the extensions on. Example chek,c,5,5,[C]heck for personal messages,[Filename] Actb - Changes the viewing status of a particular board when the user is viewing messages with the All Boards option enabled. Putting this into a mult command will allow boards to be enabled or disabled automatically. To turn the board on, enter the positive board number, to turn the same board off enter the board number with a negative sign in front. The * key will turn all boards off. The # key will turn all boards on. example: actb,a,100,5,[A]ctivate boards {here,this is an invisible command} mult,m,5,5,[M]essage #2 area,a;-1;2;3;4;-5;-6;-7;8;9;-10;q;m2 mult,m2,100,5,extended mult command,a;11;12;13;-14;-15...etc;m3 menu,m3,100,5,Message #2 area menu file,Menu2.bbs Chgm - Change the message area. The file boards.bbs contains all of the allowable board names along with their security and id number. (ie 2,5,Fun and Games) | | | id number---- | Name security ------ Example Chgm,c,5,5,[C]hange message areas .pa FILE COMMANDS ------------- Shof - Shows the current file area. This command may be located anywhere in the menu that's desired. The access and view security should be set higher then 100 (because they have no effect and should not be viewed or executed). Example Shof,xc,105,105, Invisible Show File command, Down - Download a file from the current file directory. If the file exists, the transfer protocol is requested (ascii or xmodem). If all is well, the program is sent the the requesting user. Example Down,d,6,6, [D]ownload a file Auto - Auto-download a file in xmodem protocol. First checks for user's ability to do so and then querys for a filename.The bbs then takes control of the users computer and sends a file xmodem (checksum). This capability was designed by Bob Mahoney for his Exec-Pc BBS. Example auto,a,5,5,[A]uto-download a file Upld - Upload a file to the bbs. Asks for a file name and if the name is unique, the protocol is requested. (ascii or xmodem) The file is then taken from the user and stored on the disk. Example Upld,u,5,5, [U]pload a file,\upload\ Lifi - List the files in the current directory. The optional file name contains the name of the file holding the directories contents. Files.bbs is often used for this. The filename will have the directory path applied to the beginning of the name. Example Lifi,l,5,5, [L]ist files in this directory,files.bbs Chgu - Change the upload file area. The file area names are contained in the file upload.bbs. The filename in the command can contain the name of a textfile that will be output in leu of the normal list of file areas (thereby making graphics and formated area lists possible) Example Chgu,1,5,5, [C]hange download file area,upload.dir Chgd - Change the download file area. The file area names are contained in the file download.bbs. The filename in the command can contain the name of a textfile that will be output in leu of the normal list of file areas (thereby making graphics and formated area lists possible) Example Chgu,1,5,5, [C]hange upload file area,upload.dir Newf - Check for new files in the file directory. This will query the user for a date (return if present date) and then will list out the files that meet that criteria. Example Newf,n,5,5,[N]ew files,files.bbs Seaf - Check the file directory for files that match an inputed string. Example Seaf,s,5,5,[S]earch files for a string,files.bbs MISC COMMANDS ------------- Ques - Allows a questionaire to be asked and answered. The questionaire is a standard text file with several lines of questions. Each line is read and displayed to the user. The user is then prompted for an answer to the question. Form of the command is Ques,q,5,5, [Q]uestionaire ,ques In this example the file Ques.que will contain the list of questions. The file Ques.ans will be created (when the first user activates the ques command) and the replies to the questions will be appended to that file. Autp - Auto-post a text file. This will allow the user to upload a file that will overwrite an existing file. Its' main use is for remote sysops to update frequently changing bulletins. Example: Autp,a,50,50, [A]uto-Post Bulletin #1,\bullet\bull1.txt Text - Prints out a text file of name filename (appearing after the command text. The file will be printed to the bbs's screen as well as the modem. After 22 lines have been printed the logee will be asked to (c)ontinue, (n)on-stop, or (s)top. He also has the ability to abort the printout via a ^K (control K) keypress during text output. example: Text,b,5,5, [B]ulletins of the day,bull.txt Menu - Load and execute a new menu file. If the menu filename was contained in the Menus.bbs file, the complete menu was already loaded into memory and will be displayed immediately. If not contained in the Menus.bbs file, the program will search the for the menu filename and load it if found. If not found it will issue a message to that effect. Example: Menu,f,5,5, [F]iles Section,files.mnu Cmnt - Comment. Can display info on the menu but will have no effect if the command is activated. Also the command letter will not be displayed in the short menu. Example: Cmnt,xxx,5,5,-------------Bulletins of the Day----------- Xprt - Toggle the expert mode. Turns the expert mode on if off or off if currently on. The user file will be updated with the latest status of this flag. In the expert menu, only the short menus are shown. Example Xprt,x,5,5, [X]pert user toggle List - List the users. Example List,s,5,5, [S]how bbs's users Mult - Execute multiple commands immediately. The filename in the command line contains a string which the bbs will handle as if the user entered it. Example chgf,1,5,5, 1-Change to fun and games directory,\fun\ chgf,2,5,5, 2-Change to turbo pascal directory,\turbo\ Lifi,l,5,5,[L]ist files in this directory Mult,a,5,5,List [A]ll files,1;l;2;l Example menu,m,5,5,[M]essage area,mess.mnu mult,l,5,5,[L]eave a comment for sysop,m;e;sysop;comment;y;q Revf - Output a textfile in reverse order. The entire file is read in (maximum lines=200) and then the file is displayed last line first. This can be quite useful for displaying the callers log. This command may be interrupted by typing ^K (control K). Example Revf,r,100,100,Show [C]allers log,callers.log Seat - Check a text file for an inputed string. Example Seat,s,5,5,[S]earch file for a string,bullet12 Quit - Leave the program after confirm. After activation, the program asks the person "Do you really wish to log off (y/n)?-". If the answer is y the person is given the goodbye.bbs message and the modem hangs up. example Quit,g,5,5, [G]oodbye and Logoff (after verify) Term - Log Off immediately. Display the goodbye.bbs file and drop carrier. Example Term,c,5,5,[C]rash the system Chat - Checks for presence of sysop (by beeping speaker a few times) and if sysop desires conversation with user, a conference mode is begun. Example chat,y,5,5,[Y]ell for the sysop Quer - Allows menu query line to be customized as the sysop desires. If this statement is omitted from the present menu, the options that are contained in that menu will be displayed as follows: Example quer,xxx,5,5,Enter Command [option1 option2...optionN]?- will appear as Enter Command [option1 option2 ... optionN]?- Show - Will list the long form of the menu. This is useful when the user has expert status but can't remember a particular command and needs a fast look-see at the allowable commands (without switching off his expert status). Example show,?,5,5,[?]-Help for this menu Ment - Displays a file instead of the menu option list. Allows longer and more detailed menus. example ment,xxx,100,5,dummy,main.txt Will output text file main.txt instead of the menu. The short options (ie Enter option [x1 x2 x3...xn]- ) or the QUER statment will still be in effect. Stat - Shows the users statistics (password, ,graphics, scroll, uploads, downloads and time on today) and allows change thereof. example stat,s,5,5, [S]tatisics for this user Defm - Define a macro key. Allows a series of characters to be assigned to a single entry (1-3 keystrokes). Every time the entry is entered into the system, if it is unique in the current menu, the series of characters is applied to the command buffer and executed one after another. Example Defm,d,5,5, [D]efine macro key, When d is entered the user is prompted for the key access and then the characters to be executed from that key access. Each user may have up to 10 macros assigned. Syst - Show the system statistics. Display Rybbs version #, Number of callers since last re-boot and current time and date. Example Syst,Y,15,5, S[Y]stem Stats, SYSOP COMMANDS -------------- Boot - After current user logs off, this will exit the program and hopefully re-start. This can be useful for editing a menu file already in memory. Since editing the file on disk won't actually have an effect until the program reads the menu file we can restart the program and load them in that way. Example Boot,b,100,100, [B]oot the system Edit - Edit users file. Allows the users.bbs file to be displayed and altered. Example Edit,u,100,100,Edit [U]sers file Edtx - Edit a text file. Load a text file and display it. Then by a numbered line system give the user the ability to change and redisplay the file. If acceptable, the altered file may be stored to disk as the same name. Example Edtx,t,100,100,Edit [T]ext File,files.mnu Exec - Execute a command. The file 'online.bbs' contains a list of dos commands (entered exactly as from a keyboard) which are displayed and given an option number. If one of their numbers is chosen that file will be executed (if possible). If 0 is entered a dos command is allowed. If insufficient memory exists, the command will be ignored. Example Allowable commands: DIR>COM1 REN file1.ext file2.ext COPY \dir1\file1.exe \dir2 Fmove \dir1\filename \dir2 etc. Example exec,x,100,100,e[X]ecute a dos command Runp - Run a program. The file 'programs.bbs' contains a list of dos commands (entered exactly as from a keyboard) which are displayed and given an option number. If one of their numbers is chosen that file will be executed (if possible). If insufficient memory exists, the command will be ignored. Example runp,x,10,10,[R]un an external program Make - Create a textfile. Filename is contained in command line. Example Make,m,100,100,[M]ake a new callers.log,callers.log Lcom - Outputs a remark to a text file. Will normally be used within a MULT command but could be used anytime. Normal use (as I see it) would be to flag a certain user activity. Example lcom,t,100,5,User read bulletin #15,callers.log text,b15,100,5,bulletin 15,bullet15. mult,15,5,5, [15]-Read bulletin 15,t;b15 When the number 15 is entered at the menu (by the user) the effect will be to write the string 'User read bulletin #15' to the callers.log and then to actually output the text file bullet15. Noop - No Operation ---------------------------------------------------------------- Files ---------------------------------------------------------------- Board directories * ---------------- * The files Boards.bbs must be present on startup of the RYBBS. This file * defines the various message bases available and their security levels. * The optional file name parameter is used if separate message files are * setup. If this parameter is omitted, then rmess.bbs and rline.bbs files * are assumed as the message base. * * The optional message files must be created by making copies of RMESS.BBS * and RLINE.BBS to new names. * * The format of the files is as follows: * * number,security,Message Board name,[filename] * * For example: * * 1,5,General Message Area * 2,10,Requests for Public Domain Software * ---------------------------------------------------------------- * File directories ---------------- The files download.bbs and upload.bbs must be present on startup of the RYBBS. You may have as few as 1 upload and 1 download area or as many as 30 upload and 30 download areas. The format of the files is as follows: number,security,descriptive text,path\ Note: You must end the path with the \ sign. For example: 1,5,fun and games,\files\fun\ 2,8,private,\files\rybbs\ ---------------------------------------------------------------- Menus.bbs contain the names of the menu filenames. These menus will be loaded into memory when the program is started. It is not necessary to load the menus from the disk although it is possible. When the MENU command is issued the program checks to see if the called menu is available in memory. If it is, it's loaded immediately from memory. If not, the current directory is searched for the filename and loads the menu in from disk. Goodbye.bbs Standard text file giving users signoff information. Newuser.bbs Standard text file that is displayed to new users. Hello.bbs Standard text file that will be displayed before logon. Normally would contain system identification and not be changed. Welcome.bbs Standard text file giving users signon information before they actually log-in. Welcome1.bbs Standard text file giving users information immediately after they log-in. Callers.log Standard text file that keeps track of the activities that happen in the bbs. Downloads, uploads, logon, logoff and several other items of interest are logged in this file. Modeinit.bbs Standard text file that contains modem commands that would be sent to modem upon start of program and after each user logs off (or disconnects).Each line will be sent to modem followed by a return character (0d hex). Offhook.bbs Standard text file with modem commands to take phone 'off-hook'. ---------------------------------------------------------------- Messages are made up 2 files rmess.bbs is a file of message_type as follows: message_type=record from :string[37]; {message from} toname :string[37]; {message to} private :boolean; {is it private?} date :date_type; time :date_type; board :byte; {board for this mess} thread :integer; {replies to this mess?} startline:integer; {startline in rline.bbs} endline :integer; {ending line in rline.bbs} about :string[40]; {message short descrip.} deleted :boolean; received :boolean; prevmess :integer; misc1 :integer; misc2 :integer; misc3 :integer; end; Rmess.bbs contains the starting and ending line position of the following file...each message can therefore be as long as you wish and we can still access the information sequentially and therefore quite quickly. rline.bbs is a file of line_type as follows: line_type=string[80]; ---------------------------------------------------------------- The users file is named Users.bbs and is made up of records as follows: If no file Users.bbs is found when the program begins, one is created. NOTE: One record is generated with the name SYSOP, the password NEW, and the security level 100. YOU SHOULD IMMEDIATELY CHANGE THIS PASSWORD!!!! YOU SHOULD IMMEDIATELY CHANGE THIS PASSWORD!!!! YOU SHOULD IMMEDIATELY CHANGE THIS PASSWORD!!!! user_type=record name : string[37]; callfrom : string[30]; password : string[14]; lasttime : string[17]; phone : string[12]; credit, pending, security, uploads, downloads, totaluk, totaldk, timeson, timeleft, last_read, last_m_area, {last board 500=all} last_f_area: integer; {last download area} xpert, lockedout, deleted, universal : boolean; graphics : byte; {graphics 0=no, 1=yes} last_u_area:integer; {last upload area} extra : array[1..19] of integer; end; ---------------------------------------------------------------- Remote use of RYBBS Rybbs may be used to access your computer remotely. This capability is reserved for sysops (the program checks to make sure that the user has a security level of at least 100 before allowing access to this command). To access the computer remotely set up a batch file as follows: watchdg1 on ctty com1 command.com ctty con watchdg1 off My particular file is named Remote.bat and it is one of the choices in my online.bat file so I when I execute the exec command (from my sysop menu of course) all I need type is the number corresponding to the batch file and I'm dropped to dos with all the necessary commands activated automatically. Watchdog is a public domain program that monitors the status of the carrier detect line and if it doesn't see it, it reboots the entire system. In this manner, even if you are knocked off the modem by some line noise the system won't freeze until you manually reboot. Note: this watchdog program utilizes the timer interrupt. This means that it may or may not screw up a concurrent operating system. Watchdog may or may not run correctly with the DoubleDos concurrent operating system. Watchdog reroutes the computer's timer interrupt to monitor carrier detect constantly. Many concurrent op. systems do the same and therefore there may be some contention. ---------------------------------------------------------------- Sysop Commands Commands that the system operator will find valuable are shown below next to their associated keypresses. Key Command F1 Sysop Available Toggle F2 Sysop Bell Toggle F3 Screen Echo F4 Sysop Log-On F5 Sysop utilities F7 Force Chat with present user F8 Log user off (after verify and outputing file killuser.bbs) F9 Change users security (while he's online) F10 Drop out of program to Dos. Alt-A Kill user immediately Alt-D Sysop Drop to DOS (RYBBS remains resident!) Alt-S Erase sysop menu Alt-U Display extensive information on current or last user. Ctrl-X Quit program F1-Sysop Available Toggle This will allow the sysop to be paged (via a speaker tone). If the sysop wishes to converse with the user, he would normally press the space bar and begin to type. At the end of the chat, the sysop must press the Ctrl-Z key to exit the chat mode and return the user to the bbs. F2-Sysop Bell Toggle This will allow the sysop to be paged silently. Perhaps he's working nearby or viewing the screen and doesn't need to hear the chat tone. F3-Screen Echo Show just about everything the remote user sees to the sysop. Disabling this option should make the user's display run slightly faster since the information being displayed does not have to be repeated on the bbs console. F4-Sysop Log-on This will allow the sysop to log onto the system locally. The bbs will act nearly identically to the way it acts remotely. The only differences will be that downloads and uploads might be a bit difficult and the boot command (see below) won't work. When the sysop logs on the modem will normally go 'off hook' so that it sounds as if the bbs line is busy. F5-Sysop utilities This will pop up the sysop utility menu. This is explained in detail below. F7-Force Chat When the F7 key is pressed, the user online would be immediately interrupted and told that the sysop desires to converse with him. After the chat is complete, the sysop presses the Ctrl-Z key to return the user to the regular operation of the bbs. F8-Log User Off This will give the sysop the ability to disconnect the current user. When the F8 key is pressed the sysop is prompted to make sure he does really wish to disconnect this user. If the answer is yes then, it will output the file KillUser.bbs (if available) and then disconnects the user. This is normally the 'nice' way to disconnect somebody. The killuser.bbs file often contains a messages indicating that the sysop requires the system and they should call back. F9-Change User Security This will allow the sysop to increase (or decrease) the security level of the presently on-line user. Note: this security level WILL be recorded in the user's file as a permanent (until changed again) item. F10-Exit to Dos Stops the program immediately. Does not log the user off. Alt-A- Disconnects the user immediately. Does not give a reason or output any file. Used normally for pest callers. Sets the lock-out flag on the current user. Alt-D- Drop to DOS. Allows local sysop to drop to DOS without exiting * RYBBS. Uses standard DOS shell technique. Type "EXIT" to return to * RYBBS. * * Alt-S Allows the sysop menu to be removed from the screen. Increases the width of the sysops screen to the full 80 columns. Alt-U- Displays extensive information about the currently logged-on caller * or the most recent caller. * ---------------------------------------------------------------- Disclaimer ---------- Although this program has been tested extensively, Gregory J. Ryan shall in no way be responsible for any special, incidental, consequential or other damages. The use of this program is at the USERS OWN risk. ---------------------------------------------------------------- If you have any questions about this program please call Dent-Tech at 1-414-224-1062.